docs(testing): improve standalone testing documentation - #31313
Merged
thetaPC merged 3 commits intoAug 10, 2026
Conversation
Add context about using exported `componentOnReady` helper to make tests more accurate for custom-element builds.
|
@Zac-Smucker-Bryan is attempting to deploy a commit to the Ionic Team on Vercel. A member of the Team first needs to authorize it. |
Merged
6 tasks
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Zac-Smucker-Bryan
changed the title
thetaPC
requested changes
Aug 4, 2026
thetaPC
left a comment
thetaPC
left a comment
Contributor
There was a problem hiding this comment.
Thanks for picking this up, the Angular section is solid. The React and Vue sections are that same section copied across though, and the facts don't carry over (no /standalone route in either test app, no IonicModule outside Angular), so please verify guidance against each framework's own source before duplicating it. Suggestions left inline.
Accept changes from code review, clarifying for each framework. Co-authored-by: Maria Hutt <thetaPC@users.noreply.github.com>
Contributor
Author
|
OK, changes accepted. Let me know if you need anything else from me. |
thetaPC
requested changes
Aug 10, 2026
Helper explanation in its own section since it applies to both routes, and mapped the helper's two branches onto /lazy and /standalone so it's clear what guarantee each one gives. Co-authored-by: Maria Hutt <thetaPC@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Issue number: resolves #31312
What is the current behavior?
Current docs don't provide recommended testing guidance for accurately testing standalone components. This can create issues because a standalone (custom-elements) build doesn't expose
el.componentOnReady(), so any test that reads fixture.nativeElement before hydration in a standalone project has the potential to not be testing what they think they are.What is the new behavior?
componentOnReadyhelper from@ionic/corein Angular'stesting.mdfiletesting.mdfiles for React and VueDoes this introduce a breaking change?